Base class for box containers
<!-- ##### SECTION Long_Description ##### -->
-<para>\r
-GtkBox is an abstract widget which encapsulates functionallity for a\r
-particular kind of container, one that organizes a variable number of\r
-widgets into a rectangular area. GtkBox currently has two derived\r
-classes, #GtkHBox and #GtkVBox.\r
-</para>\r
-<para>\r
-The rectangular area of a GtkBox is organized into either a single row\r
-or a single column of child widgets depending upon whether the box is\r
-of type #GtkHBox or #GtkVBox, respectively. Thus, all children of a\r
-GtkBox are allocated one dimension in common, which is the height of a\r
-row, or the width of a column.\r
-</para>\r
-<para>\r
-GtkBox uses a notion of <emphasis>packing</emphasis>. Packing refers to\r
-adding widgets with reference to a particular position in a\r
-#GtkContainer. For a GtkBox, there are two reference positions: the\r
-<emphasis>start</emphasis> and the <emphasis>end</emphasis> of the box. For a\r
-#GtkVBox, the start is defined as the top of the box and the end is\r
-defined as the bottom. For a #GtkHBox the start is defined as the\r
-left side and the end is defined as the right side.\r
-</para>\r
-<para>\r
-Use repeated calls to gtk_box_pack_start() to pack widgets into a\r
-GtkBox from start to end. Use gtk_box_pack_end() to add widgets from\r
-end to start. You may intersperse these calls and add widgets from\r
-both ends of the same GtkBox.\r
-</para>\r
-<para>\r
-Use gtk_box_pack_start_defaults() or gtk_box_pack_end_defaults()\r
-to pack widgets into a GtkBox if you do not need to specify the\r
-<structfield>expand</structfield>, <structfield>fill</structfield>, or\r
-<structfield>padding</structfield> attributes of the child to be\r
-added.\r
-</para>\r
-<para>\r
-Because GtkBox is a #GtkContainer, you may also use\r
-gtk_container_add() to insert widgets into the box, and they will be\r
-packed as if with gtk_box_pack_start_defaults(). Use\r
-gtk_container_remove() to remove widgets from the GtkBox.\r
-</para>\r
-<para>\r
-Use gtk_box_set_homogeneous() to specify whether or not all children\r
-of the GtkBox are forced to get the same amount of space.\r
-</para>\r
-<para>\r
-Use gtk_box_set_spacing() to determine how much space will be\r
-minimally placed between all children in the GtkBox.\r
-</para>\r
-<para>\r
-Use gtk_box_reorder_child() to move a GtkBox child to a different\r
-place in the box.\r
-</para>\r
-<para>\r
-Use gtk_box_set_child_packing() to reset the\r
-<structfield>expand</structfield>, <structfield>fill</structfield>,\r
-and <structfield>padding</structfield> attributes of any GtkBox child.\r
-Use gtk_box_query_child_packing() to query these fields.\r
+<para>
+GtkBox is an abstract widget which encapsulates functionality for a
+particular kind of container, one that organizes a variable number of
+widgets into a rectangular area. GtkBox currently has two derived
+classes, #GtkHBox and #GtkVBox.
+</para>
+<para>
+The rectangular area of a GtkBox is organized into either a single row
+or a single column of child widgets depending upon whether the box is
+of type #GtkHBox or #GtkVBox, respectively. Thus, all children of a
+GtkBox are allocated one dimension in common, which is the height of a
+row, or the width of a column.
+</para>
+<para>
+GtkBox uses a notion of <emphasis>packing</emphasis>. Packing refers to
+adding widgets with reference to a particular position in a
+#GtkContainer. For a GtkBox, there are two reference positions: the
+<emphasis>start</emphasis> and the <emphasis>end</emphasis> of the box.
+For a #GtkVBox, the start is defined as the top of the box and the end is
+defined as the bottom. For a #GtkHBox the start is defined as the
+left side and the end is defined as the right side.
+</para>
+<para>
+Use repeated calls to gtk_box_pack_start() to pack widgets into a
+GtkBox from start to end. Use gtk_box_pack_end() to add widgets from
+end to start. You may intersperse these calls and add widgets from
+both ends of the same GtkBox.
+</para>
+<para>
+Use gtk_box_pack_start_defaults() or gtk_box_pack_end_defaults()
+to pack widgets into a GtkBox if you do not need to specify the
+#GtkBox:expand, #GtkBox:fill, or #GtkBox:padding child properties
+for the child to be added.
+</para>
+<para>
+Because GtkBox is a #GtkContainer, you may also use
+gtk_container_add() to insert widgets into the box, and they will be
+packed as if with gtk_box_pack_start_defaults(). Use
+gtk_container_remove() to remove widgets from the GtkBox.
+</para>
+<para>
+Use gtk_box_set_homogeneous() to specify whether or not all children
+of the GtkBox are forced to get the same amount of space.
+</para>
+<para>
+Use gtk_box_set_spacing() to determine how much space will be
+minimally placed between all children in the GtkBox.
+</para>
+<para>
+Use gtk_box_reorder_child() to move a GtkBox child to a different
+place in the box.
+</para>
+<para>
+Use gtk_box_set_child_packing() to reset the #GtkBox:expand,
+#GtkBox:fill and #GtkBox:padding child properties.
+Use gtk_box_query_child_packing() to query these fields.
</para>
<!-- ##### SECTION See_Also ##### -->
-<para>\r
-<variablelist>\r
-\r
-<varlistentry>\r
-<term>#GtkHBox</term>\r
-<listitem><para>a derived class that organizes widgets into a row.</para></listitem>\r
-</varlistentry>\r
-\r
-<varlistentry>\r
-<term>#GtkVBox</term>\r
-<listitem><para>a derived class that organizes widgets into a column.</para></listitem>\r
-</varlistentry>\r
-\r
-<varlistentry>\r
-<term>#GtkFrame</term>\r
-<listitem><para>a #GtkWidget useful for drawing a border around a GtkBox.</para></listitem>\r
-</varlistentry>\r
-\r
-<varlistentry>\r
-<term>#GtkTable</term>\r
-<listitem><para>a #GtkContainer for organizing widgets into a grid,\r
-rather than independent rows or columns.</para></listitem>\r
-</varlistentry>\r
-\r
-<varlistentry>\r
-<term>#GtkLayout</term>\r
-<listitem><para>a #GtkContainer for organizing widgets into arbitrary\r
-layouts.</para></listitem>\r
-</varlistentry>\r
-\r
-</variablelist>\r
-\r
+<para>
+<variablelist>
+
+<varlistentry>
+<term>#GtkHBox</term>
+<listitem><para>a derived class that organizes widgets into a row.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>#GtkVBox</term>
+<listitem><para>a derived class that organizes widgets into a column.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>#GtkFrame</term>
+<listitem><para>a #GtkWidget useful for drawing a border around a GtkBox.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>#GtkTable</term>
+<listitem><para>a #GtkContainer for organizing widgets into a grid,
+rather than independent rows or columns.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>#GtkLayout</term>
+<listitem><para>a #GtkContainer for organizing widgets into arbitrary
+layouts.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkBox ##### -->
-<para>\r
-The #GtkBox-struct describes an instance of GtkBox and contains the following fields.\r
-(These fields should be considered read-only. They should never be set by\r
-an application.)\r
-\r
-<informaltable pgwide="1" frame="none" role="struct">\r
-<tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/>\r
-<tbody>\r
-\r
-<row>\r
-<entry>#GList * <structfield>children</structfield>;</entry>\r
-<entry>a list of children belonging the GtkBox. The data is a list of\r
-structures of type #GtkBoxChild-struct.</entry>\r
-</row>\r
-\r
-<row>\r
-<entry>#gint16 <structfield>spacing</structfield>;</entry>\r
-<entry>the number of pixels to put between children of the GtkBox, zero\r
-by default. Use gtk_box_set_spacing() to set this field.</entry>\r
-</row>\r
-\r
-<row>\r
-<entry>#guint <structfield>homogeneous</structfield>;</entry>\r
-<entry>a flag that if %TRUE forces all children to get equal space in\r
-the GtkBox; %FALSE by default. Use gtk_box_set_homogeneous() to set this\r
-field.</entry>\r
-</row>\r
-</tbody></tgroup></informaltable>
-</para>
-
-@children:
-@spacing:
-@homogeneous:
+<para>
+The #GtkBox-struct describes an instance of GtkBox and contains the
+following fields. (These fields should be considered read-only.
+They should never be set by an application.)
+</para>
+
+@children: a list of children belonging the GtkBox.
+ The data is a list of structures of type #GtkBoxChild-struct.
+@spacing: the number of pixels to put between children of the GtkBox,
+ zero by default. Use gtk_box_set_spacing() to set this field.
+@homogeneous: a flag that if %TRUE forces all children to get equal
+ space in the GtkBox; %FALSE by default. Use gtk_box_set_homogeneous()
+ to set this field.
<!-- ##### ARG GtkBox:homogeneous ##### -->
<para>
</para>
<!-- ##### STRUCT GtkBoxChild ##### -->
-<para>\r
-The #GtkBoxChild-struct holds a child widget of GtkBox and describes\r
-how the child is to be packed into the GtkBox. Use\r
-gtk_box_query_child_packing() and gtk_box_set_child_packing() to query\r
-and reset the <structfield>padding</structfield>,\r
-<structfield>expand</structfield>, <structfield>fill</structfield>,\r
-and <structfield>pack</structfield> fields.\r
-</para>\r
-<para>\r
-#GtkBoxChild-struct contains the following fields. (These fields\r
-should be considered read-only. They should never be directly set by an\r
-application.)\r
-\r
-<informaltable pgwide="1" frame="none" role="struct">\r
-<tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/>\r
-<tbody>\r
-\r
-<row>\r
-<entry>#GtkWidget * <structfield>widget</structfield>;</entry>\r
-<entry>the child widget, packed into the GtkBox.</entry>\r
-</row>\r
-\r
-<row>\r
-<entry>#guint16 <structfield>padding</structfield>;</entry>\r
-<entry>the number of extra pixels to put between this child and its\r
-neighbors, set when packed, zero by default.</entry>\r
-</row>\r
-\r
-<row>\r
-<entry>#guint <structfield>expand</structfield>;</entry>\r
-<entry>flag indicates whether extra space should be given to this\r
-child. Any extra space given to the parent GtkBox is divided up among\r
-all children with this attribute set to %TRUE; set when packed, %TRUE by\r
-default.</entry>\r
-</row>\r
-\r
-<row>\r
-<entry>#guint <structfield>fill</structfield>;</entry>\r
-<entry>flag indicates whether any extra space given to this child due to its\r
-<structfield>expand</structfield> attribute being set is actually\r
-allocated to the child, rather than being used as padding\r
-around the widget; set when packed, %TRUE by default.</entry>\r
-</row>\r
-\r
-<row>\r
-<entry>#guint <structfield>pack</structfield>;</entry> <entry>one of\r
-#GtkPackType indicating whether the child is packed with reference to\r
-the start (top/left) or end (bottom/right) of the GtkBox.</entry>\r
-</row>\r
-</tbody></tgroup></informaltable>\r
+<para>
+The #GtkBoxChild-struct holds a child widget of GtkBox and describes
+how the child is to be packed into the GtkBox. Use
+gtk_box_query_child_packing() and gtk_box_set_child_packing() to query
+and reset the <structfield>padding</structfield>,
+<structfield>expand</structfield>, <structfield>fill</structfield>,
+and <structfield>pack</structfield> fields.
+</para>
+<para>
+#GtkBoxChild-struct contains the following fields. (These fields
+should be considered read-only. They should never be directly set by an
+application.)
</para>
-@widget:
-@padding:
-@expand:
-@fill:
-@pack:
+@widget: the child widget, packed into the GtkBox.
+@padding: the number of extra pixels to put between this child and its
+ neighbors, set when packed, zero by default.
+@expand: flag indicates whether extra space should be given to this
+ child. Any extra space given to the parent GtkBox is divided up
+ among all children with this attribute set to %TRUE; set when packed,
+ %TRUE by default.
+@fill: flag indicates whether any extra space given to this child due
+ to its @expand attribute being set is actually allocated to the child,
+ rather than being used as padding around the widget; set when packed,
+ %TRUE by default.
+@pack: one of #GtkPackType indicating whether the child is packed with
+ reference to the start (top/left) or end (bottom/right) of the GtkBox.
@is_secondary:
+
<!-- ##### FUNCTION gtk_box_pack_start ##### -->
-<para>\r
-Adds @child to @box, packed with reference to the start of @box. The\r
-@child is packed after any other child packed with reference to the\r
-start of @box.\r
-</para>
-
-@box: a #GtkBox.
-@child: the #GtkWidget to be added to @box.
-@expand: %TRUE if the new child is to be given extra space allocated to\r
-@box. The extra space will be divided evenly between all children of\r
-@box that use this option.
-@fill: %TRUE if space given to @child by the @expand option is\r
-actually allocated to @child, rather than just padding it. This\r
-parameter has no effect if @expand is set to %FALSE. A child is\r
-always allocated the full height of a #GtkHBox and the full width of a\r
-#GtkVBox. This option affects the other dimension.
-@padding: extra space in pixels to put between this child and its\r
-neighbors, over and above the global amount specified by\r
-<structfield>spacing</structfield> in #GtkBox-struct. If @child is a\r
-widget at one of the reference ends of @box, then @padding pixels are also put\r
-between @child and the reference edge of @box.
+<para>
+
+</para>
+
+@box:
+@child:
+@expand:
+@box
+@fill:
+@padding:
<!-- ##### FUNCTION gtk_box_pack_end ##### -->
-<para>\r
-Adds @child to @box, packed with reference to the end of @box. The\r
-@child is packed after (away from end of) any other child packed with reference to the\r
-end of @box.\r
-</para>
-
-@box: a #GtkBox.
-@child: the #GtkWidget to be added to @box.
-@expand: %TRUE if the new child is to be given extra space allocated to\r
-@box. The extra space will be divided evenly between all children of\r
-@box that use this option.
-@fill: %TRUE if space given to @child by the @expand option is\r
-actually allocated to @child, rather than just padding it. This\r
-parameter has no effect if @expand is set to %FALSE. A child is\r
-always allocated the full height of a #GtkHBox and the full width of a\r
-#GtkVBox. This option affects the other dimension.
-@padding: extra space in pixels to put between this child and its\r
-neighbors, over and above the global amount specified by\r
-<structfield>spacing</structfield> in #GtkBox-struct. If @child is a\r
-widget at one of the reference ends of @box, then @padding pixels are also put\r
-between @child and the reference edge of @box.
+<para>
+
+</para>
+
+@box:
+@child:
+@expand:
+@fill:
+@padding:
<!-- ##### FUNCTION gtk_box_pack_start_defaults ##### -->
-<para>\r
-Adds @widget to @box, packed with reference to the start of @box. The\r
-child is packed after any other child packed with reference to the\r
-start of @box.\r
-</para>\r
-<para>\r
-Parameters for how to pack the child @widget,\r
-<structfield>expand</structfield>, <structfield>fill</structfield>,\r
-and <structfield>padding</structfield> in #GtkBoxChild-struct, are given their default\r
-values, %TRUE, %TRUE, and 0, respectively.\r
+<para>
+
</para>
-@box: a #GtkBox.
-@widget: the #GtkWidget to be added to @box.
+@box:
+@widget:
<!-- ##### FUNCTION gtk_box_pack_end_defaults ##### -->
-<para>\r
-Adds @widget to @box, packed with reference to the end of @box. The\r
-child is packed after (away from end of) any other child packed with\r
-reference to the end of @box.\r
-</para>\r
-<para>\r
-Parameters for how to pack the child @widget,\r
-<structfield>expand</structfield>, <structfield>fill</structfield>,\r
-and <structfield>padding</structfield> in #GtkBoxChild-struct, are given their default\r
-values, %TRUE, %TRUE, and 0, respectively.\r
+<para>
+
</para>
-@box: a #GtkBox.
-@widget: the #GtkWidget to be added to @box.
+@box:
+@widget:
<!-- ##### FUNCTION gtk_box_get_homogeneous ##### -->
<!-- ##### FUNCTION gtk_box_set_homogeneous ##### -->
-<para>\r
-Sets the <structfield>homogeneous</structfield> field of\r
-#GtkBox-struct, controlling whether or not all children of @box are\r
-given equal space in the box.\r
+<para>
+
</para>
-@box: a #GtkBox.
-@homogeneous: a boolean value, %TRUE to create equal allotments,\r
-%FALSE for variable allotments.
+@box:
+@homogeneous:
<!-- ##### FUNCTION gtk_box_get_spacing ##### -->
<!-- ##### FUNCTION gtk_box_set_spacing ##### -->
-<para>\r
-Sets the <structfield>spacing</structfield> field of #GtkBox-struct,\r
-which is the number of pixels to place between children of @box.\r
+<para>
+
</para>
-@box: a #GtkBox.
-@spacing: the number of pixels to put between children.
+@box:
+@spacing:
<!-- ##### FUNCTION gtk_box_reorder_child ##### -->
-<para>\r
-Moves @child to a new @position in the list of @box children. The\r
-list is the <structfield>children</structfield> field of\r
-#GtkBox-struct, and contains both widgets packed #GTK_PACK_START as\r
-well as widgets packed #GTK_PACK_END, in the order that these widgets\r
-were added to @box.\r
-</para>\r
-<para>\r
-A widget's position in the @box children list determines where the\r
-widget is packed into @box. A child widget at some position in the\r
-list will be packed just after all other widgets of the same packing\r
-type that appear earlier in the list.
-</para>
-
-@box: a #GtkBox.
-@child: the #GtkWidget to move.
-@position: the new position for @child in the\r
-<structfield>children</structfield> list of #GtkBox-struct, starting\r
-from 0. If negative, indicates the end of the list.
+<para>
+
+</para>
+
+@box:
+@child:
+@position:
<!-- ##### FUNCTION gtk_box_query_child_packing ##### -->
-<para>\r
-Returns information about how @child is packed into @box.\r
+<para>
+
</para>
-@box: a #GtkBox.
-@child: the #GtkWidget of the child to query.
-@expand: the returned value of the <structfield>expand</structfield>\r
-field in #GtkBoxChild-struct.
-@fill: the returned value of the <structfield>fill</structfield> field\r
-in #GtkBoxChild-struct.
-@padding: the returned value of the <structfield>padding</structfield>\r
-field in #GtkBoxChild-struct.
-@pack_type: the returned value of the <structfield>pack</structfield>\r
-field in #GtkBoxChild-struct.
+@box:
+@child:
+@expand:
+@fill:
+@padding:
+@pack_type:
<!-- ##### FUNCTION gtk_box_set_child_packing ##### -->
-<para>\r
-Sets the way @child is packed into @box.\r
-</para>
-
-@box: a #GtkBox.
-@child: the #GtkWidget of the child to set.
-@expand: the new value of the <structfield>expand</structfield> field\r
-in #GtkBoxChild-struct.
-@fill: the new value of the <structfield>fill</structfield> field in\r
-#GtkBoxChild-struct.
-@padding: the new value of the <structfield>padding</structfield>\r
-field in #GtkBoxChild-struct.
-@pack_type: the new value of the <structfield>pack</structfield> field\r
-in #GtkBoxChild-struct.
+<para>
+</para>
+@box:
+@child:
+@expand:
+@fill:
+@padding:
+@pack_type:
}
}
+/**
+ * gtk_box_pack_start:
+ * @box: a #GtkBox
+ * @child: the #GtkWidget to be added to @box
+ * @expand: %TRUE if the new child is to be given extra space allocated to
+ * @box. The extra space will be divided evenly between all children of
+ * @box that use this option
+ * @fill: %TRUE if space given to @child by the @expand option is
+ * actually allocated to @child, rather than just padding it. This
+ * parameter has no effect if @expand is set to %FALSE. A child is
+ * always allocated the full height of a #GtkHBox and the full width
+ * of a #GtkVBox. This option affects the other dimension
+ * @padding: extra space in pixels to put between this child and its
+ * neighbors, over and above the global amount specified by
+ * #GtkBox:spacing property. If @child is a widget at one of the
+ * reference ends of @box, then @padding pixels are also put between
+ * @child and the reference edge of @box
+ *
+ * Adds @child to @box, packed with reference to the start of @box.
+ * The @child is packed after any other child packed with reference
+ * to the start of @box.
+ */
void
gtk_box_pack_start (GtkBox *box,
GtkWidget *child,
gtk_widget_thaw_child_notify (child);
}
+/**
+ * gtk_box_pack_end:
+ * @box: a #GtkBox
+ * @child: the #GtkWidget to be added to @box
+ * @expand: %TRUE if the new child is to be given extra space allocated
+ * to @box. The extra space will be divided evenly between all children
+ * of @box that use this option
+ * @fill: %TRUE if space given to @child by the @expand option is
+ * actually allocated to @child, rather than just padding it. This
+ * parameter has no effect if @expand is set to %FALSE. A child is
+ * always allocated the full height of a #GtkHBox and the full width
+ * of a #GtkVBox. This option affects the other dimension
+ * @padding: extra space in pixels to put between this child and its
+ * neighbors, over and above the global amount specified by
+ * #GtkBox:spacing property. If @child is a widget at one of the
+ * reference ends of @box, then @padding pixels are also put between
+ * @child and the reference edge of @box
+ *
+ * Adds @child to @box, packed with reference to the end of @box.
+ * The @child is packed after (away from end of) any other child
+ * packed with reference to the end of @box.
+ */
void
gtk_box_pack_end (GtkBox *box,
GtkWidget *child,
gtk_widget_thaw_child_notify (child);
}
+/**
+ * gtk_box_pack_start_defaults:
+ * @box: a #GtkBox
+ * @widget: the #GtkWidget to be added to @box
+ *
+ * Adds @widget to @box, packed with reference to the start of @box.
+ * The child is packed after any other child packed with reference
+ * to the start of @box.
+ *
+ * Parameters for how to pack the child @widget, #GtkBox:expand,
+ * #GtkBox:fill and #GtkBox:padding, are given their default
+ * values, %TRUE, %TRUE, and 0, respectively.
+ */
void
gtk_box_pack_start_defaults (GtkBox *box,
GtkWidget *child)
gtk_box_pack_start (box, child, TRUE, TRUE, 0);
}
+/**
+ * gtk_box_pack_end_defaults:
+ * @box: a #GtkBox
+ * @widget: the #GtkWidget to be added to @box
+ *
+ * Adds @widget to @box, packed with reference to the end of @box.
+ * The child is packed after any other child packed with reference
+ * to the start of @box.
+ *
+ * Parameters for how to pack the child @widget, #GtkBox:expand,
+ * #GtkBox:fill and #GtkBox:padding, are given their default
+ * values, %TRUE, %TRUE, and 0, respectively.
+ */
void
gtk_box_pack_end_defaults (GtkBox *box,
GtkWidget *child)
gtk_box_pack_end (box, child, TRUE, TRUE, 0);
}
+/**
+ * gtk_box_set_homogeneous:
+ * @box: a #GtkBox
+ * @homogeneous: a boolean value, %TRUE to create equal allotments,
+ * %FALSE for variable allotments
+ *
+ * Sets the #GtkBox:homogeneous property of @box, controlling
+ * whether or not all children of @box are given equal space
+ * in the box.
+ */
void
gtk_box_set_homogeneous (GtkBox *box,
gboolean homogeneous)
return box->homogeneous;
}
+/**
+ * gtk_box_set_spacing:
+ * @box: a #GtkBox
+ * @spacing: the number of pixels to put between children
+ *
+ * Sets the #GtkBox:spacing property of @box, which is the
+ * number of pixels to place between children of @box.
+ */
void
gtk_box_set_spacing (GtkBox *box,
gint spacing)
return box->spacing;
}
+/**
+ * gtk_box_reorder_child:
+ * @box: a #GtkBox
+ * @child: the #GtkWidget to move
+ * @position: the new position for @child in the list of children
+ * of @box, starting from 0. If negative, indicates the end of
+ * the list
+ *
+ * Moves @child to a new @position in the list of @box children.
+ * The list is the <structfield>children</structfield> field of
+ * #GtkBox-struct, and contains both widgets packed #GTK_PACK_START
+ * as well as widgets packed #GTK_PACK_END, in the order that these
+ * widgets were added to @box.
+ *
+ * A widget's position in the @box children list determines where
+ * the widget is packed into @box. A child widget at some position
+ * in the list will be packed just after all other widgets of the
+ * same packing type that appear earlier in the list.
+ */
void
gtk_box_reorder_child (GtkBox *box,
GtkWidget *child,
gtk_widget_queue_resize (child);
}
+/**
+ * gtk_box_query_child_packing:
+ * @box: a #GtkBox
+ * @child: the #GtkWidget of the child to query
+ * @expand: pointer to return location for #GtkBox:expand child property
+ * @fill: pointer to return location for #GtkBox:fill child property
+ * @padding: pointer to return location for #GtkBox:padding child property
+ * @pack_type: pointer to return location for #GtkBox:pack-type child property
+ *
+ * Returns information about how @child is packed into @box.
+ */
void
-gtk_box_query_child_packing (GtkBox *box,
- GtkWidget *child,
- gboolean *expand,
- gboolean *fill,
- guint *padding,
- GtkPackType *pack_type)
+gtk_box_query_child_packing (GtkBox *box,
+ GtkWidget *child,
+ gboolean *expand,
+ gboolean *fill,
+ guint *padding,
+ GtkPackType *pack_type)
{
GList *list;
GtkBoxChild *child_info = NULL;
}
}
+/**
+ * gtk_box_set_child_packing:
+ * @box: a #GtkBox
+ * @child: the #GtkWidget of the child to set
+ * @expand: the new value of the #GtkBox:expand child property
+ * @fill: the new value of the #GtkBox:fill child property
+ * @padding: the new value of the #GtkBox:padding child property
+ * @pack_type: the new value of the #GtkBox:pack-type child property
+ *
+ * Sets the way @child is packed into @box.
+ */
void
-gtk_box_set_child_packing (GtkBox *box,
- GtkWidget *child,
- gboolean expand,
- gboolean fill,
- guint padding,
- GtkPackType pack_type)
+gtk_box_set_child_packing (GtkBox *box,
+ GtkWidget *child,
+ gboolean expand,
+ gboolean fill,
+ guint padding,
+ GtkPackType pack_type)
{
GList *list;
GtkBoxChild *child_info = NULL;
/**
* GtkRange::change-value:
- * @range: the range that received the signal.
- * @scroll: the type of scroll action that was performed.
- * @value: the new value resulting from the scroll action.
+ * @range: the range that received the signal
+ * @scroll: the type of scroll action that was performed
+ * @value: the new value resulting from the scroll action
* @returns: %TRUE to prevent other handlers from being invoked for the
- * signal. %FALSE to propagate the signal further.
+ * signal, %FALSE to propagate the signal further
*
* The ::change-value signal is emitted when a scroll action is
* performed on a range. It allows an application to determine the
/**
* GtkRange:show-fill-level:
*
- * The show-fill-level property controls wether fill level indicator
+ * The show-fill-level property controls whether fill level indicator
* graphics are displayed on the trough. See
* gtk_range_set_show_fill_level().
*
/**
* GtkRange:restrict-to-fill-level:
*
- * The restrict-to-fill-level proeprty controls whether slider
+ * The restrict-to-fill-level property controls whether slider
* movement is restricted to an upper boundary set by the
- * fill-level. See gtk_range_set_restrict_to_fill_level().
+ * fill level. See gtk_range_set_restrict_to_fill_level().
*
* Since: 2.12
**/
*
* The spacing between the stepper buttons and thumb. Note that
* setting this value to anything > 0 will automatically set the
- * trough-under-steppers style property to TRUE as well. Also,
+ * trough-under-steppers style property to %TRUE as well. Also,
* stepper-spacing won't have any effect if there are no steppers.
*/
gtk_widget_class_install_style_property (widget_class,
/**
* GtkRange:trough-side-details:
*
+ * When %TRUE, the parts of the trough on the two sides of the
+ * slider are drawn with different details.
+ *
* Since: 2.10
*/
gtk_widget_class_install_style_property (widget_class,
*
* Whether to draw the trough across the full length of the range or
* to exclude the steppers and their spacing. Note that setting the
- * stepper-spacing style property to any value > 0 will
+ * #GtkRange:stepper-spacing style property to any value > 0 will
* automatically enable trough-under-steppers too.
*
* Since: 2.10
* continuous. #GTK_UPDATE_DISCONTINUOUS means that the value will only
* be updated when the user releases the button and ends the slider
* drag operation.
- *
**/
void
gtk_range_set_update_policy (GtkRange *range,
* is normally 0 for #GtkScale and nonzero for #GtkScrollbar, and
* indicates the size of the visible area of the widget being scrolled.
* The page size affects the size of the scrollbar slider.
- *
**/
void
gtk_range_set_adjustment (GtkRange *range,
* slider moves from top to bottom or left to right. Inverted
* ranges have higher values at the top or on the right rather than
* on the bottom or left.
- *
**/
void
gtk_range_set_inverted (GtkRange *range,
* The step size is used when the user clicks the #GtkScrollbar
* arrows or moves #GtkScale via arrow keys. The page size
* is used for example when moving via Page Up or Page Down keys.
- *
**/
void
gtk_range_set_increments (GtkRange *range,
*
* Sets the current value of the range; if the value is outside the
* minimum or maximum range values, it will be clamped to fit inside
- * them. The range emits the "value_changed" signal if the value
- * changes.
- *
+ * them. The range emits the #GtkRange::value-changed signal if the
+ * value changes.
**/
void
gtk_range_set_value (GtkRange *range,
projects / gtk4.git / commitdiff